搜索客，搜索人自己的社区

Elasticsearch 6/7/8 到 Easysearch 2.x 迁移指南

Easysearch • INFINI Labs 小助手发表了文章 • 0 个评论 • 7 次浏览 • 18 分钟前 • 来自相关话题

![](https://infinilabs.cn/img/blog ... er.jpg)

最近在协助客户进行 Elasticsearch 到 Easysearch 的迁移时，发现大家最关心的问题是"当前版本能否直接使用快照迁移"。这个问题看似简单，但不同版本的答案差异较大。本文将基于实际测试经验，梳理各版本的迁移路径和注意事项。

迁移路径速览

根据源 ES 版本，可以直接对照下表选择迁移方案：

| 源 ES 版本 | 能否直接快照恢复 | 推荐方案 | 实施复杂度 |
| -------------- | :--------------: | ------------------------------------- | :--------: |
| ES 6.x | 否 | INFINI Gateway 迁移或 ES 7.10.x 中转 | 较低 |
| ES 7.0 - 7.11 | 是 | 直接快照恢复 | 较低 |
| ES 7.12 - 7.17 | 否 | INFINI Gateway 迁移 | 较低 |
| ES 8.x | 否 | INFINI Gateway 迁移 | 较低 |

结论：ES 7.0-7.11 是迁移最顺畅的版本窗口，可直接快照恢复；其他版本也有成熟的迁移方案，只是路径不同。

版本差异的原因

迁移路径的差异主要源于两方面：Lucene 版本兼容性和快照元数据格式变化。

Lucene 兼容性：Easysearch 2.x 底层要求的最低 Lucene 版本对应 ES 7.0.0。ES 6.x 的索引文件使用老版本 Lucene，直接恢复会报错：

 The index was created with version [6.8.23] but the minimum compatible version is [7.0.0]. 

快照元数据格式：ES 7.12 开始在快照中引入 uuid、cluster_id 字段，7.14 增加 writer_uuid，8.x 又引入 transport_version。这些字段与 Easysearch 2.x 的快照解析器不兼容。

因此，ES 7.0-7.11 成为迁移的"黄金窗口"——既满足 Lucene 兼容性要求，快照格式又足够简洁。

ES 7.0-7.11：直接快照恢复

这是测试最充分的迁移路径，已验证版本包括 ES 7.0.1、7.8.1、7.10.2 OSS、7.11.2。

已验证能力：

单索引 / 多索引 / 通配符批量恢复
常见字段类型与别名
自定义 settings、多分片索引
ILM 托管索引、数据流后备索引、冻结索引

操作步骤：

```bash

1. 源 ES 创建快照

PUT /_snapshot/my_backup/snapshot_1
{
"indices": "索引列表",
"include_global_state": false
}

2. Easysearch 注册同一快照仓库

PUT /_snapshot/my_backup
{
"type": "fs",
"settings": {
"location": "/path/to/snapshot/repo",
"readonly": true
}
}

3. 恢复快照

POST /_snapshot/my_backup/snapshot_1/_restore
{
"indices": "索引列表",
"include_global_state": false
}
```

ES 6.x：Gateway 迁移或中转方案

ES 6.x 无法直接快照恢复到 Easysearch 2.x，有两种迁移方案可选：

方案一：INFINI Gateway 迁移（推荐）

直接使用 Gateway 从 ES 6.x 迁移数据到 Easysearch，无需中转集群。Gateway 已验证支持 ES 6.8.x 的数据迁移。

方案二：ES 7.10.x 中转

 ES 6.8 -> 快照 -> ES 7.10.x -> 快照 -> Easysearch 2.x 

ES 7.10.x 可以正常恢复 ES 6.x 的快照，恢复完成后再创建快照供 Easysearch 使用。该方案数据完整性有保障，但需要额外的中转存储和迁移窗口。

ES 6.x 特有字段：ES 6.x 的 string 类型在 Easysearch 中需映射为 text 或 keyword（根据实际使用场景选择）。

ES 7.12+ 和 8.x：INFINI Gateway 迁移

这两个版本段的快照格式与 Easysearch 2.x 不兼容，推荐使用 INFINI Gateway 进行迁移。Gateway 是 INFINI Labs 提供的数据迁移工具，专门针对 Elasticsearch 到 Easysearch 的迁移场景进行了优化。

架构示意

 ┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐ │ Elasticsearch │ ──── │ INFINI Gateway │ ──── │ Easysearch │ │ （源集群） │ │ （迁移工具） │ │ （目标集群） │ └─────────────────┘ └─────────────────┘ └─────────────────┘ 

Gateway 内部通过 Scroll API 从源集群分批拉取数据，再通过 Bulk API 写入目标集群，整个过程对业务透明。

主要优势
配置简单：只需配置源集群和目标集群地址、索引名称即可
断点续传：支持从断点恢复，避免网络抖动导致重头再来
进度可视：实时显示迁移进度和速率
多索引并行：支持同时迁移多个索引

基本步骤
1. 在目标集群创建索引的 mapping 和 setting
2. 准备 Gateway 配置文件，填写源集群和目标集群连接信息
3. 运行 Gateway 执行迁移
4. 迁移完成后进行数据校验
  
  详细的配置说明和操作示例，可参考 [ES 数据迁移之 INFINI Gateway](https://infinilabs.cn/blog/202 ... teway/)。
  
  备选方案
  
  如果需要更灵活的控制，也可以自行编写脚本，通过 Scroll API 读取源数据、Bulk API 写入目标。这种方式适合有定制化需求的场景，但需要自行处理断点续传、错误重试等逻辑。
  
  字段类型兼容性
  
  直接兼容类型：text、keyword、long、double、boolean、date、object、nested、geo_point、geo_shape、ip、completion、wildcard、flattened、alias、join、rank_feature、rank_features、integer_range、long_range、date_range、match_only_text 等。
  
  ES 7.x / 8.x 需替换类型：
  
  | ES 类型 | Easysearch 替代方案 | 数据保留 | 说明 |
  | ------------------------- | ------------------------ | :------: | --------------------------------- |
  | dense_vector | knn_dense_float_vector | 是 | 需安装 knn 插件，向量数据格式兼容 |
  | knn_vector | knn_dense_float_vector | 是 | 需安装 knn 插件 |
  | sparse_vector | knn_sparse_bool_vector | 是 | 需安装 knn 插件 |
  | constant_keyword | keyword | 是 | 需手动维护常量值 |
  | runtime | 移除或转为普通字段 | 是 | Easysearch 不支持运行时字段 |
  | histogram | object | 是 | 聚合 histogram 功能丢失 |
  | aggregate_metric_double | object | 是 | 需手动计算聚合 |
  | unsigned_long | long 或 keyword | 是 | 注意数值范围 |
  | semantic | 暂不支持 | - | ES 专有 AI 功能 |
  
  向量迁移要点：ES 的 dense_vector 数据可直接迁移到 Easysearch 的 knn_dense_float_vector，数据格式 [0.1, 0.2, ...] 完全兼容。需预先在目标索引创建正确的 mapping。
  
  建议迁移前先用小索引测试，确认 mapping 无问题后再全量迁移。
  
  常见问题与避坑指南
  
  1. include_global_state 参数设置
  
  该参数控制是否恢复集群级配置（模板、ILM 策略等）。不同版本的情况：
  
  | ES 版本 | 发行版 | global_state | 说明 |
  | -------- | ------- | ------------ | -------------------------------- |
  | 7.0-7.7 | 任意 | 兼容 | 无 _index_template API |
  | 7.8-7.10 | OSS | 兼容 | 无内置 _index_template |
  | 7.8-7.10 | default | 可能不兼容 | 取决于是否使用 _index_template |
  | 7.11+ | 任意 | 不兼容 | 有 9 个内置 _index_template |
  
  建议：迁移时统一使用 include_global_state=false，先恢复数据再重建配置。
  
  2. ILM 和 data stream 迁移
ILM：索引的 lifecycle 设置保留，但 policy 需在 Easysearch 中重建
数据流 (data stream)：后备索引 (backing index) 数据完整恢复，语义需在目标侧重建
冻结索引 (frozen index)：自动恢复为普通可访问状态

3. 迁移验收标准

建议至少完成三项验证：
文档量一致
关键查询结果一致
核心业务链路压测通过

4. 迁移窗口规划
快照方案通常需要短停机窗口完成切换
Gateway 迁移可实现近实时同步，仅在切换连接时短暂停服

快照格式变化参考

| 字段 | ES 7.0-7.11 | ES 7.12-7.17 | ES 8.x | Easysearch 2.x |
| ------------------- | :---------: | :----------: | :----: | :------------: |
| min_version | 7.9.0 或无 | 7.12.0 | 7.12.0 | 支持 |
| uuid（仓库级） | 无 | 有 | 有 | 不支持 |
| cluster_id | 无 | 有 | 有 | 不支持 |
| writer_uuid | 无 | 有（7.14+） | 有 | 不支持 |
| transport_version | 无 | 无 | 有 | 不支持 |

总结

本文梳理了 Easysearch 2.x 对 ES 6/7/8 的迁移路径：
ES 7.0-7.11：直接快照恢复，路径最短
ES 6.x：INFINI Gateway 迁移或 ES 7.10.x 中转
ES 7.12+ / 8.x：使用 INFINI Gateway 迁移

建议在正式迁移前，先选择非核心索引进行小规模验证，确认数据完整性和业务兼容性后再扩大迁移范围。

如有迁移相关问题，欢迎联系我们。

通知设置新通知

发现

Elasticsearch 6/7/8 到 Easysearch 2.x 迁移指南

迁移路径速览

版本差异的原因

ES 7.0-7.11：直接快照恢复

1. 源 ES 创建快照

2. Easysearch 注册同一快照仓库

3. 恢复快照

ES 6.x：Gateway 迁移或中转方案

ES 7.12+ 和 8.x：INFINI Gateway 迁移

架构示意

主要优势

基本步骤

备选方案

字段类型兼容性

常见问题与避坑指南

1. `include_global_state` 参数设置

2. ILM 和 data stream 迁移

3. 迁移验收标准

4. 迁移窗口规划

快照格式变化参考

总结

【搜索客社区日报】第2242期 (2026-06-02)

【搜索客社区日报】第2243期 (2026-06-03）

【搜索客社区日报】第2241期 (2026-06-01）

【搜索客社区日报】第2240期 (2026-05-28）

【搜索客社区日报】第2239期 (2026-05-27）

【搜索客社区日报】第2238期 (2026-05-25)

【搜索客社区日报】第2237期 (2026-05-25)

【搜索客社区日报】第2237期 (2026-05-25）

【搜索客社区日报】第2236期 (2026-05-22）

【搜索客社区日报】第2235期 (2026-05-21）

【搜索客社区日报】第2234期 (2026-05-20）

【搜索客社区日报】第2233期 (2026-05-19）

【搜索客社区日报】第2232期 (2026-05-18）

【搜索客社区日报】第2231期 (2026-05-15）

活动推荐

热门话题

通知设置 新通知

发现

迁移路径速览

版本差异的原因

ES 7.0-7.11：直接快照恢复

1. 源 ES 创建快照

2. Easysearch 注册同一快照仓库

3. 恢复快照

ES 6.x：Gateway 迁移或中转方案

ES 7.12+ 和 8.x：INFINI Gateway 迁移

架构示意

主要优势

基本步骤

备选方案

字段类型兼容性

常见问题与避坑指南

1. include_global_state 参数设置

2. ILM 和 data stream 迁移

3. 迁移验收标准

4. 迁移窗口规划

快照格式变化参考

总结

活动推荐

热门话题

通知设置新通知

1. `include_global_state` 参数设置